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1 INTRODUCTION AND OVERVIEW 
1 BACKGROUND 


The lacs driver Interface services (Idis) IS a component of 
the lacs driver in the lan subsystem... The Idis Is the lacs 
driver's Interface to a user application, and the lacs driver's 
layer servers (ls). 


1.2 BASIC PURPOSE 


The Idis has several purposes, they are: to receive requests 
from applications using the lan subsystem, to determine which 
layer server to Invoke from requests [Issued to the lan subsystem, 
to provide common routines used by the layer servers, to provide 
initialization services routines, to provide termination services 
routines, to provide power failure routines to handle power 
failure In the 16. 


1.3 BASIC STRUCTURE 


Figure 1 shows the relation of the Idis to the ofher 
components of the lacs driver. Figure 2 shows the subcomponents 
of the Ildis. The following fs a brief description of the 
functions of each subcomponent of the idis: 


forb processing routines - The lacs driver must have 
i -routines [n place to Interface with the user. The user will 
ee, use the $rqio Interface. The lforb processing routines In 
the I|dis are routines which Interface with the user. These 
routines accept the $rqio from the user and release the 
$rqio when the lan subsystem is finished processing the 

request. The forb processing routines are defined below: 


Interface services pre forb processing = This routine 
Is responsible for receiving the user request, 
performing some validation of the request, placing the 
request on the appropriate rct queue (the rect [Is know 
from the Irn [n the forb), then [fnvoking either a layer 
server, or either an f[nitialization service routine or 
a termination service routine. 


Interface services post forb processing - This 
routine Is responsible for posting all requests back to 
the user, after the layer server or one of the 
Initialization or termination services has completed 
processing the request. 


common layer server routines - The layer servers are 
structured such that they contain common functions To 


perform In processing requests. . The common layer server 
routines [In the Idis are the common functions used by the 
modules of the layer servers. The common routine are 


defined below: 
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LACS DRIVER INTERFACE SERVICES SUBCOMPONENTS 


figure 2 ; 
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iorb validation routine - This routine will validate 

fields that are common to all layer servers. 7 
builld a Icb routine - This routine will ffll in ffelds = 
that are common to all layer servers [n the Icb. 

terminate task - This routine will terminate a task 


level when called. 


event routine - This routine will perform some event. 
request processing for a layer server. 


assign segement visIblity - This routine will call the 
executive to gain visiblity to a user's segement so a 
layer server can access the [forb's buffer. 


buffer address absolutizing routine - This routine 
will call the executive to convert a virtual address 
Into a physical address. | 


More common function routines will be added as 
development continues. 


sap Initialization services =- A user of the lan subsystem 
will need to retrieve [Information from the lacs driver In 
order to use the lan subsystem. The Initialization services 
routines In the Idfis allows a user to retrieve information 
to use In it's $rqlio Interface. The initialization services 
aslo provides service fo perform [nitialization for a sap 
(remote and local). The routines are defined below: 


associate local user - This routine will return a Irn 
to a user, from a supplied symbolic name. | 


activate focal sap - This routine activates the local 
sap in the controller and the level 6. 


activate remote sap - This routine return a logical 
remote sap address to the user, from a supplied 
symbolic name. 


sap termination services = The user of the lan subsystem 
may, at some point in It's processing, wish to end it's 
association with the lan subsystem. The termination 
services routines in the IdIis are used to terminate a user's 
association with the lan subsystem and to terminate al | 
connections associated with the sap. These routines process 
all termination services whether [Issued by the user or the 
executive (disconnect with queue abort when a task group is 
abnormally aborted). The routines are defined below: 


deactivate local sap - This ‘routine process deactivate 
with queue abort forbs (disconnect with queue abort in 


16 jargon). It clears all! queue associated with the wo 
sap, then deactivates the local sap (places In a ey 
Inactive state) In the 16 and in the controller. In a ee 
connect f oOo n 3 
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orfented enviroment, this routine causesS- any 
-_ connection associated with the sap to be disconnected, 
( all other queues to be cleared and the sap to be 
placed [In a Inactive state. 


dsactivate remote sap - This routine will deactivate 
remote saps, the routine Is needed to clear up 
resources held by remote saps. 


power fail routine - The lan subsystem must have routines In 
place to handle power failure (pf) by the 16. The pf 
restart routine [in the Idis are required because the goal of 
the pf restart routines [s to reinitialize the lacs and make 
It's services available again. The routines will place the 
lan subsystem into a state where [It was when the 16 was 
booted, (f.e. no user had Interfaced to the lan subsystem). 
The routines are defined below: : 


1st power failure routine - This routine Is Invoked by 

7 the executive at level 2 during It's power failure 
restart operation. The routine simulates an [Interrupt 
to the lowest lan subsystem Interrupt level (highest 
priority), then changes the p=counter [In the lowest 
level's teb to the start of the 2nd power fail 
routine. 


2nd power failure routine =- This routine [s Invoked as 
a result of the Ist pf routine simulating an [Interrupt 
and changing the p-counter for [t's level. The 
routine will post all current request outstanding to 
the lan subsystem back to the user, cleans up al/| 
structures, and if any levels are active, the routine 
deactivates the levels. 


1.4 BASIC OPERATION 
1.4.1 BASIC FLOW OF THE IORB PROCESSING ROUTINES 
1.4.1.1 INTERFACE SERVICES IORB PREPROCESSING ROUTINE 


The Interface services lforb processing routine will be 
Invoked as a result of any request made to the lan subsystem 
(execpt associate local user). The routine will fetch the Irn 
from the forb, then [ndex Into the Irt by the Irn to obtain the 
pointer to the rect. The routine will test the active bit in the 
ret, If the bit Is not set and If the request is not an activate, 
the routine will call the exec dequeue and post routine to post 
the request with an error. Otherwise, the routine will dequeue 
the Irb off the tcb queue, and enqueue the [rb on the tall of 
the rb queue on the rect. The routine will then fetch the forb 
function code, and [ff the request [{S not one of the 
Initiallzation or termination routine functions the routine will 
then fetch the start address of the layer server from the rct, 
and jump to the address. Otherwise, the routine will jump to the 
appropriate [Initialization or termination service routine. 
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re ee ee INTERFACE SERVICES 10RB PROCESSING ROUTINE ERRORS 
Errors which are reported In processing the request are: 
1. Ret fs not active. | 
2. j&IInvalid forb function code. 
3. Invalid forb parameter. 
1.4.1.2 INTERFACE SERVICES IORB POST PROCESSING ROUTINE 
The Interface services torb post processing routine will be 
Invoked as a result of a call from a lacs driver module (layer 
server) wishing to dequeue and post a request back to a user. 


Three parameters must be passed when calling the routine, the 
pointer to the rct, the pointer to the Irb, and the return 


status. The routine will dequeue the Irb off the rect queue of 
irbs, then call the executive to post the request back to the 
user. The routine will then return to it's caller. 


1.4.1.2.1 INTERFACE SERVICES IORB POST PROCESSING ROUTINE ERRORS 
Errors which are reported In posting the request are: 
1. Invalid parameters from a caller... 
2. Executive errors in posting the request. 
1.4.1.3 SUMMARY OF THE I0RB PROCESSING ROUTINES 
Regardless of -the request, the Interface services’ forb 


preprocessor routine is [Invoked when each request Is Issued, the 
routine selects the appropriate layer server. The layer server 


process the request, and upon completion cal! the interface 
services post lforb routine. The interface services post forb 
routine posts the request back to the user, then returns to The 
Is. 


1.4.2 BASIC FLOW OF THE INITIALIZATION SERVICES ROUTINES 
1.4.2.1 ASSOCIATE USER MCL 


The user of the lan subsystem [s required to use a Irn [In 
the ltorb. This fs obtained by an associate user mcl. The user 
must supply a symbolic name as an Input parameter. The routine 
will search the user directory until a matching symbolic name is 
found. The routine then call the executive's "get physical 
device" routine to associate the Irn with the user's task group. 
The executive returns to the routine. The routine then returns 
the Irn to the user with a successful completion status. 


1.4.2.1.1 ASSOCIATE USER MCL ERRORS 


Errors which are reported by the mcl routine are: 


a 
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( 1. A matching symbolic name [s not found. 
: 2. The Irn Its already [In use by another task group. 
1.4.2.2 ACTIVATE LOCAL SAP ROUTINE 


The user fs required to perform the activate local = sap 
request after performing the associate local user mcl. The 
activate local sap request Is required by the lan subsystem 
becase the sap must be activated. The user must supply the Irn 
and proper function code In the lan type torb. The routine will 
validate the forb, call the sys mgr Is. Upon return from the sys 
mgr Is the routine will bulld an activate local sap Icb Including 
the symbolic name of the sap (the symbolic name is retrieved from 
the local sap table). The Icb Is then [Issued to the controller. 


The controller will place a 16 bit logical address in: The Icb and 
return It to the 16. The activate routine will place the logical 
address into the local sap table, then will post the request 


successfully back to the user. 
1.4.2.2.1 ACTIVATE LOCAL SAP ROUTINE ERRORS 
Errors which are reported by the activate routine are: 
1. Invalid forb parameter. 
( 2. Sap Is already active. 
~ 3. Sys mgr Is returns with an error. 
4. Controller returns with an error. 


1.4.2.5 ACTIVATE REMOTE SAP ROUTINE 


The user must perform an activate remote sap request after 


the activate local sap request. The user must supply a Irn 
(representing the local sap) and a symbolic name (representing 
the remote point) In the lan type torb. The routine will 
validate the forb. The routine will then build a activate remote 
sap Icb Including the symbolic name of the remote sap. The Icb 
Is then Issued to the controller. The controller will place the 
16 bit logical remote address Into the Icb and return to the 16. 
The activate remote sap routine will place the logical remote 
address into the forb. The routine will then successfully return 


to the caller. 
1.4.2.3.1 ACTIVATE REMOTE SAP ROUTINE ERRORS 
Errors which are reported by the activate routine are: 
1. Invalld ftorb parameter. 


2. A matching symbolic name was not found In the 16. 


a .4Q. = 
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14435 


3. A matching symbolic name was not found [fn the 
lacs. 


4. Controller return with an error. 


BASIC FLOW OF THE TERMINATION SERVICES ROUTINES | 


1.4.3.1 DEACTIVATE LOCAL SAP ROUTINE 


The executive will Issue a deactivate local sap request when 
the task group using the sap aborts abnormally, or a user can 
Issue a deactivate local sap request at anytime. The request is 


destructive to all current operations. The ftorb will be 
validated once the request [s recefved by the routine. The 
routine will then retrieve the rct from the Irn [n the forb, and 


queue the Irb on the tail of the rect Irb queue. The routine wil 
mark the rect as deactivating, this Is done to prevent subsequent 


requests from being processed. The routine will then build a 
Icb, [Issue the request to the lacs . The lacs will abort al 
outstanding orders it currently has active for the local sap, the 
lacs will also desolve any connection associated with the sap, 
and post the orders back to the 16, finally the lacs will post 
the deactivate local sap Icb back to the 16. The layer server 
will post each request received from the lacs back to the user 
with the appropriate status. The deactivate local sap routine 
will be fnvoked when the deactivate Icb is completed, when this 
happens the routine will mark the rct as not active and post the 
deactivate local sap request back to the Issuer. In a connection 
orfented enviroment all connections will be disconnected by the 
routine. 


1.4.3.1.1  DEACTIVATE LOCAL SAP ROUTINE ERRORS 


Errors which are reported by the deactivate sap routine are: 
1. Invalid forb parameters. 


Z. Invalid logical local sap. 


1.4.3.2 DEACTIVATE REMOTE SAP ROUTINE 


The deactivate remote sap routine, Is used by an application 
to free up resources taken up by the remote sap. The routine 


will be used [In future releases, currently the routine will 
require a tan type forb with a Irn and the logical remote sap the 
user wishes to deactivate. The routine will validate the forb. 
The routine will bulld the deactivate remote sap Icb and Issue it 
to the lacs. The lacs will deactivate the remote sap, then 
return the I!cb to the 16. The routine will clean up data 


structures . associated with the remote sap, then return 
successfully to the caller. 


1.4.5.2.1 DEACTIVATE REMOTE SAP ROUTINE ERRORS 
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Errors which are reported by the remote sap deactivation 
( routine are: 
7 1. Invalid forb parameter. 
2. %Invalid logical remote sap. 
1.4.4 BASIC FLOW OF THE COMMON LAYER SERVER ROUTINES 
1.4.4.1 TERMINATE TASK ROUTINE 


This routine will be called by als or an [nftiallzation or 
termination routine when it would Ifke to terminate it's task 
level. The routine will call the executive terminate task 
routine which will terminate the current task level. 


1.4.4.1.1 TERMINATE TASK ROUTINE ERRORS 
No errors. 
1.4.4.2 BUILD LCB ROUTINE 


The bulld lIcb routine requires a Icb as a [nput parameter. 


The routine will ffll fn ffelds tn the Icb from information [tn 
data structures, which were also passed as Input parameters. ‘The 
routine will return to it's caller after it fills tn common lIcb 
fields. 


i 4.4.2.1 BUILD LCB ROUTINE ERRORS 


Errors which are reported by the bulld Icb routine are: 
Ike Invalid f[nput parameters. 
1.4.4.5 VALIDATE IORB ROUTINE 
The validate lan type lorb routine requires a forb as a 
input parameter. The routine will validate that the forb [Is a 
lan type request. The routine will return to [t's caller after 
It has validated the forb Is of lan type. 
1.4.4.5.1 VALIDATE I!ORB ROUTINE ERRORS 
Errors which are reported by the validate fiorb routine are: 
1. lorb [s not a lan type forb. 
1.4.5 BASIC FLOW OF THE POWER FAIL ROUTINE 
1.4.5.1 FIRST POWER FAIL RESTART ROUTINE 


The first power fail restart routine (pfrs) Is [Invoked after 
the level 6 experiences a power failure. The routine fs Invoked 


via a call from the exec pfrs routine. The routine Is 
responsible for invoking the second pfrs routine, then returnig 
t o tT hoe e x ec p f ri s 


a. 4o 
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routine. 
1.4.5.2 SECOND POWER FAIL RESTART ROUTINE 


The second pfrs routine {fs fnvoked by the first pfrs 
-routine. The routine will clear all queues of active Icbs, post 
all active forbs back to the users, clean up all data structures, 
and terminate any active lan subsystem levels. The routine will 
place the lan subsystem Into the state it was in before the first 
associate. The routine will supend i[tself when processing is 
complete. 


1.4.5.3 POWER FAIL ROUTINE ERRORS 
The power fail routines do no report any errors. 
1.5 MAJOR DEPENDENCIES 
1.5.1 EXECUTIVE RESOURCES 
The mod400 executive software supplies routines which are 
used by the Ildls. These routines deal with [rb and_ tforb 
processing and tasking. 
1.5.2 SYSTEM MANAGER LAYER SERVER RESOURCES 
The sys mgr Is _ provides additional processing for the 
activate local and remote user requests, and the deactivate and 
deactivate with queue abort requests by supplying routines which 
are called by the appropriate Idis routine. 
Z EXTERNAL SPECIFICATION 
2.1 OWNED DATA STRUCTURES 


The 16 lan subsystem data structures are defined In the data 
structures document. 


2.2 EXTERNAL INTERFACES 
2.2.1 MOD400 EXECUTIVE SOFTWARE ROUTINES 


2.2.1.1 ZXREQ = Request task 


entry: Inj $b5,zxreq 

Input: $b4 = address of task request block 
$b5 = return address 

output: $r1 = 0 - task request was queued successfully 
$r1 > 0 - task request was not queued 
$b4 = address of task request block 


modifies: $r1,$r2,$r3,$b1,$b2,$b3 
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function: 


2.2.1.2  ZHCOMM 


function: 


2.2.1.3 2ZXD_PR 
entry: 


Inpuf: 
outpufT: 


modifies: 


functions 


.2.1.4 ZXD_TR 


2 
(- entry: 


Inputs 


outpufT: 


modifies: 


function: 


2.2.1.5 ZXPOST 
entry: 


Inputs 


Cc output: 


Request a normal task with a supplied request block 
pointer. | 


- Null address 


Will load the null address when referenced [.e. Idb 
$b5,<zhcomm will load $b5 with the null address. 


- Dequeue and post IRB 


Inj $b5,zxd_pr 


$r2 = completion status for request 
$b5 = return address 
$ri = 0 - request was dequeued and posted 


$r1 > 0 = no request on queue exist 

any register may be modified 

Post completion status to the first IRB on the request 
queue. Awaken any walters queued on the IRB, record 
completion status In the RB, return the IRB to the 
system pool. 

- Internal terminate 


Inj $b5,zxd_tr 


completion status for request 


$r2 = 

$b4 = new default start address or null 

$b5 = return 

$r1 = 0 =- no error on Internal terminate 

$b1 = address of IRB for next request or Is null If 


hardware Interrupt 
$b4 = address of RB for next request 


any register may be modified 

Dequeue and post currently dispatched request. Get 
next request In queue of task requests. Delete task 
If queue empty and delete bit on. Suspend task until 
next request or hardware Interrupt at Issuing task's 
level if queue empty and delete bit off. 

- Post IRB 


Inj $b5,zxpost 


$r1 = contains status to be returned to walter 
$b1 = points to the IRB 

$b5 = return address 

$b4 = points to the RB 
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modifies Sr1,$r2,$r3,$b1,$b4 


function: Post completion status to the referenced IRB. Awaken Oe 
any waiters queued on the IRB, record completion 
status in the RB if still attached, and return the IRB 
to the system pool. 
2e2e-1.6 ZXDQ —- Dequeue IRB 
entry: inj $b5,zxdq 
input: Sb5 = return address 
out put : Srl is status: 
0 = dequeue accomplished 
0814 = no IRB to dequeue or it is not dispatched 
Sb1 = points to the IRB 
modifies: nothing 
function: Dequeue the IRB at the head of the request queue of 
the issuing task. 
2-2-2 MOD400 EXTERNAL DATA STRUCTURES IMPLEMENTED 
| 
The following system owned data structures are referenced by the 
ldis: aos 
Task Control Block (TRB) oe 
System Control Block (SCB) 
Logical Resource Table (LRT) 
Group Control Block (GCB) 
Resource Control Table (RCT) 
Intermediate Request Block (IRB) 
2-2-3 USER INTERFACES 
2.2.3.1 ASSOCIATE LOCAL USER MCL 
entry: mcl with function code = x'2a0l1' 
input: Sb4 = a(parameter block) 
Sey Eee ee ne eee ere 
| symbolic name | - 8 bytes 
| ------------------- | 
| lrn | - 2 bytes 
Where the symbolic name is supplied by the user and 
the lrn is supplied by the system. 
output: Sb4 = a(parameter block) - described above eee. 
Scl = status co . 


es ce 
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0000 - association successful 
( 0781 - matching symbolic name not found 
’ 0782 - Irn reserved by another task group 
modifies: all registers are perserved 


function: return a Irn to the user from a supplied Irn, Irn Is 
to be used In lan subsystem requests 


2.2.3.2 STANDARD I!ORB FORMAT 
rb_Irx 


Input - bit rb_adr points to a bd when set 


Q- 
bit 1-3 - na 
bit 4-f - Irn when rb_ct2 bits O-7 = x'fd! 
output - na 3 
rborrb 
Input: na 
outpuT: na 
rboctt 
i inputs bit O-7 = mbz 
bit 8-e - na 
4 bit f - must be set 
ae. output: bit O-7 - status 
60 = event successful 
64 - invalid’ forb parmaeter 
6D = event aborted, reference rb_fss_ field 
for reason 
oc. = Inconsistent request, reference rb_ fss 
.ffleld for reason | 
bit 8-f - same as [nput 
rb_oct2 
Input: bit O-7 = Irn 
bit 8-a = na 
bit b= must be set 
bit c-f =- function code 
bit c-f = b - deactivate forb 
bit c-f = a = activate forb 
outpuT: same as [Input 
rb_adr 
[nputs: pointer to buffer, or if rb_Irx bit 0 is set this 
fleld contains a pointer to a buffer discriptor, 
or this field may be null {ff no data fs being 
passed (i.e. event forb) 
output: same as Input 
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rborng 


input: 


output: 
rb_dvs 


Inputs 


output: 
rborsr 

input: 

output: 
rb sti 


input: 
output: 


rb ext 
input: 
OoutpuT: 

rb_fsf 


Input: 


output: 


: wos 
range of the buffer, or total range of all buffers a. 
In the buffer discriptor block if bit QO In rb_Irx 
is set, or mbz if no data is being passed 
same as input 


bit O-7 =- class of service 
bit 8-f = mbz 


(note: 


bit e being set and the forb function code 


= b means this Is an exec deactivate) 


same as 


mbz 


residual 


Input 


range of the buffer for read operations 


only, or same as input for all other operations 


i 
tiem 


or 
—- 

n~Oanwaoenyawoa oO 
8 


bit O-7 
bit 8-f 
same as 


- same as Input 
invalid function code when set 
ram memory exausted when set 
ram location non-existent when set a 
ram parity error when set | ee. 
level 6 memory yellow when set | 
level 6 memory non-existent when set 
level 6 bus parity error when set 
level 6 memeory red when set 

- XX 

- XxX 

Input 


function specific function code 
lorb function code = b 


0010 = deactivate local 
0020 - deactivate remote 


iorb function code = a 


same as 


0010 = activate local 
0020 = activate remote 


Input 
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rb_fss 
( inpuT: mbz 
output: function specific status 
0001 - sap already active 
0002 - lack of resources 
0004 - controller down 
0008 - sm Is error 
0010 - Irn already In use 
0020 - sap already active 
0040 - sap already disconnected 
0080 - receive buffer too smal | 
rb_abs 
Inputs mbz 
Output: accual buffer size when rb_fss = 0080, otherwise 
same as input 
rb_lra 
input: logical remote address for deactivate remote, 
otherwise mbz 
output: logical remote address for activate remote, 


otherwise same as input 


2.2.5.2.1 ACTIVATE !ORB EXTENSION © 


(_ rb sym 

Input: 8 byte symbolic name representing sap 
output: same as Input 

rb pms 
input: proposed max sdu size 
output: same as input 

rb opmr 
inputs proposed max read credit 
output: same as Input 

rb typ 
Input: mbz 


output: Type of sap 


rbomss 
inputs: proposed maximum sdu size for activate local and 
cl user 
mbz for activate remote sap or co user 
Output:  maximun sdu size for activate local and cl user 


Same as Input for activate remote sap or co user 
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rb_ 


rb 


rb_ 


rb_ 


rb 


ER Pa AP 


rb_ 


2e2éowe 


cb_ 


cb 


iss 
Inputs 
output: 
mpr 


Input: 


Output: 


wcc 
Inputs 
outputs: 
mcc 


Input: 
Output: 


acb ° 


Inputs 
output: 
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2 DEACTIVATE !ORB EXTENSION 


dcb 


Input: 
outpuT: 


STANDARD LCB FORMATS 


pri 


Inputs 
output: 


neb 


Input: 
output: 


a a * 
\ yy 

mbz | . 7 

Ideal sdu size for activate local and cl user 

same as Input for activate remote or co user 

proposed cl data read credit for activate local 

and cl user 

mbz for activate remote or co user 

maximum number of pending cl read calls for 

activate local and cl user 

same as input for activate remote or co user 

mbz 

cl write credit for activate local and cl user 

same as Input for activate remote or co user 

mbz 

maximum number of connections supported for a 

activate local and co user 

same as input for activate remote or cl user | oe 
a 

mb2 0 

Trash 

mbz 

Trash 

mbz 

na 

mbz 

na ; 
ie ; 
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cb 


cb_ 


of a 


cb 


cb 


cb 


cb_ 


ret 


input: 
outpufT: 


_lit 


Input: 
output: 
frw 


Input: 


output: 
itp 
Inputs: 


output: 


_Iind 


Inputs: 


output: 
cw 


Input: 


output: 
fsf 


Inputs 


output: 


address of caller's rect 
Same as [Input 


address of the IIit In which this Icb will 


queued 
Same as Input 


bit 0-3 - 9 

bit 4-7 = mbz (forb major function code ?) 
bit 8=-f = xx 

Same as [nput 
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be 


address of the post processing routine, or trb, 


on null 
Same as Input 


indicators 
bit 7 = cb_itp points to a trb when set 
bit 6 = sm Icb when set 
all other bits mbz 

same as input 


bit 0-5 = mbz 

bit 6-9 = cpu number to Interrupt 
bit a-f - level to [Interrupt the cpu 
same as Input 


function specific function code 
function codes for activate Icbs are: 
OOla - activate local sap 
002a - activate remote sap 
function codes for deactivate [cbs are: 
0O01b - deactivate local sap 
002b - deactivate remote sap 
same as Input 
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cb_cts 
Input: 
output: 
cb_fss 
Inputs 
output: 
cb_cbs 
inputs: 
output: 
cb_abs 
Inputs: 
output: 
cb_isa 
inputs 
output: 
cb_lIra 
Inputs 
output: 


mbz 3 
bit 0-7 - rfu and mbz ae 
bit 86 - Invalid function code when set 

bit 9 = ram memory exausted when set 

bit a- ram location non-existent when set 

bit b = ram parity error when set 

bit c - level 6 memory yellow when set 

bit d- level 6 memory non-existent when set 

bit e- level 6 bus parity: error when set 

bit f - leve!l 6 memeory red when set 

mbz 


function specific status 
0001 - sap not active 
0002 = lack of resources 
0004 - controller unavailable 
0008 = sm layer instance error 
0040 = sap already disconnected 
0080 - recieve buffer too smal | 
0100 - jfllegal logical address 
0200 - invalid I[cb 
0400 - write credit violations 
0800 - read credit violations 


m b zZ : ee. suse 


bit 0 = Icb Is complete when set 
bit 1 - [cb not processed when set 


bit 2-f - rfu and mbz 


mbz | | 
actual buffer size If cb_fss = Q080, otherwise 
same as Input 


logical local address for cl operations 
same as input 


logical remote address for cl write operation, mbz 
for event and read operations | 
logical remote address for cl read operations, 
otherwise same as inpuf 
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_ cb_trg 
( Inputs: total byte range 
output: same as Input 
cb_bect 
Input: number of buffers 
output: same as [Input 
cb_adi 
inputs buffer #1 address 
output: same as [nput 
cb_rgl 
Input: buffer #1 range 
outpuf: same as Input 
cb_rsl | 
Inputs mbz 
output: buffer #1 residual range 
cb_adz2 
( inputs buffer #2 address 
a, output: same as Input 
cb rg2 
input: buffer #2 range 
output: same as Input 
cb rs2 
Inputs mbz 
output: buffer #2 residual range 
cb_ad3 
input: buffer #3 address 
output: same as Input 
cb_rg3 
Input: buffer #3 range 
output: same as input 
cb rs3 
input: mbz 
output: buffer #3 residual range 


ney) 
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cb_ad4 


input: 


OutTpuf: 


~¢eb_rg4 


Input: 


output: 


cb_rs4 


inputs 


Output: 


cb_ad5 


input: 


output: 


cb _rg5 


inputs 
outpuT: 
cb ors5 


Input: 
output 


cb_ad6 


Inputs 
output: 


cb_rg6 


input: 


outpuT: 


cb_rs6 


Inputs 


outpuT: 


cb_ad/ 


inputs: 


outpuT: 


cb org? 


inputs 


output: 


buffer #4 address 
Same as [input 


buffer #4- range 
same as Input 


mbz 
buffer #4 residual 


buffer #5 address 
same as Input 


buffer #5 range 
Same as [npuT 


mbz 
buffer #5 residual 


buffer #6 address 
same as Input 


buffer #6 range 
same as InpufT 


mbz 
buffer #6 residual 


buffer #7 address 
same as [npuft 


buffer #7 range 
same as [npuftf 


range 


range 


range 


Component Specification 


Lacs Driver Interface Services 


cb 


rs/ 


input: 


output: 


cb_ad8 


Input: 


output: 


cb_rg8 


Input: 


output: 


cb _rs8 


a a ere: ae 


cb_ 


(- cb_ 
cb_ 


cb_ 


cb_ 


input: 


output: 


1 ACTIVATE 


sym 


input: 


output: 


pms 


Input: 


output: 


Pre 


input: 


output: 


mss 


Inputs: 


outTpuT: 


Iss 


inputs: 


output: 
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mbz 


buffer #7 residual range 


buffer #8 address 
same as Input 


buffer #8 range 
same as Input 


mbz 


buffer #8 residual range 


LCB EXTENSION 


symbolic name of the sap 
Same as input 


proposed max sdu size 
same as input 


proposed max read credit 
Same as [Input 


proposed maximum sdu size for activate local and 
cl user 

mbz for activate remote sap or co user 

maximun sdu size for activate local and cl user 

na for activate remote sap or co user 

mbz 

[deal sdu size for activate local and cl user 


na for activate remote or co user 
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cb _mpr 


Inputs proposed cl data read credit for activate local 
and cl user 
| mbz for activate remote or co user 
output: maximum number of pending cl read calls for 
activate local and cl user 
na for activate remote or co user 


cb_wec 
inputs: mb z | 
output: cl write credit for activate local and cl user 
na for activate remote or co user 
cb_mce 
Inputs; mbz | 
output: maximum number of connections supported for a 


activate local and co user 
na for activate remote or cl user 


2.2.5.4.2 DEACTIVATE LCB EXTENSION 


The deactivate Icb uses only the standard portion of -the 
; lob. 


2.2.4 COMMON ROUTINES 


2.2.4.1 TERMINATE TASK ROUTINE (CISTMTK) 


call: Inj $b5,Istmtk 
input: $b2 = a(rct) 
output: none - task [s terminated 


modifies: all registers are perserved 


2.2.4.2 BUILD LCB ROUTINE (ISBLCB) 


call: Inj $b5,isblicb 
Inputs $b1 = a(lcb) 
$b2 = alrct) 
$b3 = a(tt) 
$b4 = al(torb) 
$b5 = alreturn) 
output: $b1 = a(lcb) 
$b2 = al(rct) 
$b3 = al(tt) 
$b4 = alftorb) 
$b5 = alreturn) 
$r1 = status 


0000 - Icb was bullt 
0001 - error occured In the build 
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modifies: $rt 


&.2.4.3 VALIDATE IORB ROUTINE (ISV1I0B) 


call: Inj $b5,isviob 

Input: $b4 = a(lorb) 
$b5 = a(return) 

output: $b4 = a(forb) 
$r1 = status 


0000 = torb validated 
0164 = Invalid ftorb 


modiffes: $r1 
2.2.4.4 EVENT ROUTINES (ISEVNT) 
call: Inj $b5,isevnt 
Input: 
output: 
modifies: 
2.2.4.5 ASSIGN SEGEMENT VISIBLITY (ISASVB) 
ise STIG Inj $b5,1sasvb 
Input: 
output: 
modifies: 
2.2.4.6 ABSOLUTIZE BUFFER (ISABSL) 
call: Inj $b5,isasvb 
input: 
output: 
modifies: 


2.5 INITIALIZATION REQUIREMENTS 


The clm process will load the Idis Into system memory, 
configure at least on e task level for the Idis to run 
When the Idisis loaded [nto memory, It will perform 
Infttialfzation subroutine. This routine will: 
( Ls Place the scb, gcb, and Irt potnters [nto vectors for 
Ly use In subsequent processing. 
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2. Set up the lan monitor call major function handling 


code by placing a pointer into the executive monitor 
call vector table at slot x'Za!. 
as Set up the associate user monitor vector, this is done 


by placing the address of the mcl routine [nto the 
lan monitor call vector table at slot x'00!'. 


4... Reclaim patch space. 


No iInitiall!zation processing Is done when The Idis Is activated 
Initially by a request. 


The Idis must be loaded Into memory before any other components 
of the lacs driver are loaded Into main memory. 


TERMINATION REQUIREMENTS 


The Idis will be active as f!ong as mod400 is active, 
therefore there are no termination requirements. 


ENV |RONMENT 


The following items are required by the IdIis for it to 
perform it's task: : | 


1. Mod400 operating system. 

25 Any 16 computer mode! except 6/10 and 6/20. 

Ds A lacs attached to the 16 megabus. 

4, System manager layer server. 

5. A user of the lan subsystem to drive the Idis. 


TIMING AND SIZE REQUIREMENTS 


Currently memory usage and timing requirements are not an 
Issue. However, ‘the code should be as efficient as possible. 


ASSEMBLY AND LINKING 


The software will be written in Series 6 Assembly Language 
using a subset of the Instruction set that fs present on all 
Series 6 systems. The Idis will be linked with the lacs driver 
megabus services module by the gcos6 mod400 |inker to produce one 


of the lacs driver's bound unfts. 


TESTING CONSIDERATIONS 


Since the product Is new, all functions will be tested by 
the developer, and software test. 


aes in ae 
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2.9 DOCUMENTATION CONSIDERATIONS 


The Idis source Iisting will tnelude a program design 
language used by the developer to aid In the maintenance by 
future developers and also to aid In the development by the 
developer. ; 

2.10 ERROR MESSAGES 

2.10.1 APPLICATION ERROR MESSAGES 

2.10.1.1 ASSOCIATE USER MCL ERROR MESSAGES 

1. 0781 - A matching symbolic name was not found. 

2. 0882 - Another task group has already reserved the Irn. 


2.10.1.2 [ORB ERROR MESSAGES 


I 0164 - Invalid ftorb parameters. 


2. 016b Request was not processed. 
3s 016c = Inconsistent request. 
2.10.2 INTERNAL ERROR MESSAGES 
Cea IST ERROR MESSAGES 
4, tbe 
3 INTERNAL SPECIFICATION 
3.1 OVERVIEW 


The Idis can be Invoked three different ways, they are: 


1. A user performing a associate user mcl, the Idfs runs 
at the user task level. 


2. A user [Issues a request to the lan subsystem, the Idis 
runs at the task level configured [In clim. 


De A layer server executing one of the common routines, 
the Idis can run at the task level configured [n clm 
or an Interrupt level configured [n clim. 

3.2 SUBCOMPONENT DESCRIPTION 


3.2.1 [ORB PROCESSING ROUTINES 


The forb preprocessing routine will be the start address of 
all request processing done by the lan subsystem. Every request 
Issued to the lan subsystem will first be processed by this 
routine. Using information In the forb the routine will elfther 


branch to a layer server or branch to another IidIis routine. 
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The user will bulld an forb and tissue [t to the lan 
subsystem. 
Invoked as a result of the request lo. The system preprocessor 
| buflld an frb, and copy data buffers and the [forb into system 


The system preprocessor (or lan preprocessor) will be 


if required to do so. The system preprocessor will fetch 


Irn from the ftorb and Index into the Irt to find the pointer 


From the ret the tcb pointer {fs obtained, and In the 


is the start address and level of the task the driver will 


operate 


the 


Is 


ee ae ee 


under. The system preprocessor queues the Irb (which 
points to the iorb on the tail of the active queue of irbs) off 
tcob. 
represented by the tcb is which the request was queued. The task 
Invoked at the forb preprocessing routine. 


The system preprocessor now schedules the _ task 


IORB PREPROCESSING ROUTINE 


The routine requires the following requires the following 
Input parameters: 


$b 1 


a(irb) 


The routine supplies the following output parameters: 


The 


$b2 
$b 1 


lorb 


a(rct) 
a(irb) 


preprocessing routine performs the following: 


Obtains the Irn from the forb. 


Indexes [nto the Irt by the Irn to obtain the polnter 
to the rct. 


Fetches the major function code from the ltorb. 


lf the rect [ts not active and the request [{S not an 
activate local user, call the dequeue and post 
executive routine to post the forb with an 
inconsistent request error or [If the power fall bit Is 
set post the request with a power fall occurred error. 


lf the rect ts active and the power fall bit is not on, 
then the routine dequeues the head [rb off the teb 
queue of active [rb's and enqueues the [rb on The Tall 
of the active irb queue of on the rct. 


If the function code is a read, write, system 


management, flow control, or event [Indicate request, 
the forb preprocessor will fetch the start address 
from the rect and branch to the address. 


lf the function code is a activate, or deactivate, the 
routine will branch to the appropriate routine. 
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8. lf the function code [s anything else the routine wil 
call the post forb routine with an [nvalid forb error 
= status, then call the terminate task routine. 


3.2.1.1  !ORB POST PROCESSING ROUTINE 


The forb post processing routine can be called by any module 
In the lacs driver. The routine requires the following input 
parameters: 


$b1 = a(Irb) 
$b2 = al(rct) 
$r1 = completion status 


0160 - request successful 

0164 - Invalid lorb parameter 

016b - request aborted 

O016¢c - Inconsistent request 
$b5 = a(return) 


The routine supplies the following output parameters: 
$b2 = a(rct) 


The routine performs the following function: 


1. Dequeue the Irb off the rect queue. ‘ 
( 2% Call the executive post Irb routine (zxpost). 
- D4 Return to the caller. 


3.2.2 INITIALIZATION SERVICES ROUTINES 


The activate local and activate remote [Initialization 
service routines are invoked by the forb preprocessor. The forb 


preprocessor will branch to the appropriate [nitialization 
routine depending on the ftorb major function code. The assoclate 
user mc! Is invoked by the lan mc! hand!ifng routine In the |Idms. 


3.2.2.1 ASSOCIATE USER MCL 


The mcl will transform a symbolic name Into a Irn. The user 
will tssue the mcl which has a function code = x't2a00!. The 
routine requires the following input parameters. 


$b5 = a(return) 

$b6 = a(scb) 

$r1 = minor function code (=00) 
$b4 = a(parameter |!Ist) 


where the parameter list Is defined as follows: 


symbolic name 
[rn 


8 bytes 
2 bytes 
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The routine supplies the following output parameters: 


$b4 = a(parameter list) 
$b6 = a(scb) 
$r1 = status 
0000 - symbolic name associated 
0781 - no matching symbolic name found 
0782 - symbolic name already associated with 
another task group 
note: if $r1 ots non zero the Irn fs not placed 
Into the parameter list, if $r1 fs zero 
the Irn {fs placed [nto the parameter 
list. 


The user supplies the symbolic name, and the routine supplies the 
Irn. The routine performs the following function: 


tT. Retrieve the pofnter to the controller directory from 
the scb. 

Zs Retrieve the pointer to the user directory from the 
cd. | 

or Search the ud until a matching symbolic name Is found. 


4, lf a match Is not found, return to the caller with an 
error status. , 


oir If a match Is found, call the executive get physical 
— device routine to associate the Irn with the user. 


6. lf the executive get physical device routine return 
with an error, return to the user with an error status 
and no Irn (error would be that the Irn fs already 
reserved by another task group). 


lg lf no error resulted [In the executive call, place the 
Irn Into the parameter structure and return to the 
caller. 


3.2.2.2 ACTIVATE LOCAL SAP REQUEST 


The activate local sap request is required by an application 
so the lan subsystem can activate the local sap in the lacs and 
in the 16. The user must supply a lan type forb with the 
following fields: 


lorb function code = c. 

Lrn from associate mci. 

Device specific word bit 0 set specifying this Is an 
activate local sap request. 

Event mask. 


The routine [fs Invoked by the forb preprocessing routine, the 
routine requires the following input parameters: 


oS ce 
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aaliatitiaed 

j 
( va 

ae, 


$b1 = a(Irb) 
$b2 = a(rct) 
The routine will supply the following output parameters: 


none - task level Is exited after posting the request. 
The routine will perform the following: 
Les Valfdate the request, if the request [Is [Invalid call 


the post forb routine with an Invalid torb parameter 
error, call the terminate task routine. 


rae Call sm Is. 

5% Retrieve the pofnter to the Ist from the rct. 

4. Build the Icb, place [In the symbolic name from the 
Ist, issue the Icb via a call to the Idms. 

a Set the sap (ret) Into activating mode, call the 
terminate task routine. 

6. When the lacs completes the request, the routine wakes 
up on Interrupt level, via a call from the Idms. | f 


an error resulted in the request, dequeue the forb 
associated with the Icb and call the post forb routine 
with an error status, return to the Idms. 


7. Place the logical name Into the Ist. Dequeue the Iforb 
associated with the Icb and call the post forb routine 
with a successful status, [issue an event Icb to the 
controller the local sap has access to, return to the 
[dms. | 


3.2.2.5 ACTIVATE REMOTE SAP REQUEST 


( 


The activate remote sap request is used by an application to 
obtain a logical remote address from a supplied symbolic name. 
The user must supply a lan type forb with the following fields 
set: 


lorb function code = c. 

Device specific word bit 1 set specifying this Is an 
activate remote sap request. 

Symbolic name representing the remote sap In the rb_ oas 
field. 


The routine is Invoked by the lforb preprocessing routine, the 
routine requires the following input parameters: 


$b 1 
$b2 


a(irb) 
a(rct) 
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The routine supplies the following output parameters: 


task level [fs exited after posting the request back to the 
user with the logical remote sap address. 

The routine will perform the following: 
1. Validate the request, [if the forb [Is [nvalid call the 


post forb routine to post the request with an [nvalid 
iorb parameter error, call the terminate routine. 


Obtain the pointer to the cd from the scb. 
Retrieve the pointer to the appropriate remote sap 


directory from the cd, this Is determined by The local 
sap (layer). | 


Search the remote -sap directory until a matching 
symbolic name [Is found, if a matching sysmbofc name Is 
not found call the post forb routine with a Invalid 


ijorb error status, call the terminate task routine. 


lf a match Is found, determine from the controller 
mask if the local sap can access the remote sap, If 
the remote sap cannot access the local, call the post 
forb routine with an [nvalid forb error status, call 
the terminate Task routine. 


Determine form the adapter mask if the local sap can 
access the remote sap, If the remote sap cannot access 
the local, call the post forb routine with an invalid 
lorb error status, call the terminate task routine. 


Bulld the activate remote Icb, place In the symbolic 
name from the forb, call the Idms to [Issue the Icb. 


Call the terminate task routine. 


When the lacs completes the request, the routine wakes 


up on Interrupt level, via a call from the Idms. | f 
an error resulted in the request, dequeue the forb 
associated with the Icb and call the post forb routine 


with an error status, return to the Idms. 

Place the logical number Into the ftorb rb_dad field, 
place the logical number into the rst, mask in fhe 
controller bits. 


Dequeue the forb, and call the post forb routine with 
a successful status. 


Return to the Idms. 


a 


gr 
é 


Lacs 


34223 


Driver Interface Services Component Specification 


TERMINATION SERVICE ROUTINES 


The termination service routines are Invoked by the forb 


preprocessor. The forb preprocessor will branch to the 
deactivate local sap routine when the forb function code is = b. 
The deactivate local sap routine will check the device specific 
word [fn the ltorb, and If bit f ts set, the routine will invoke 
the deactivate remote sap routine. Otherwise, I[f bit e Is set 
the routine will process the deactivate local sap request. lf. 
bit e or f Is not set the routine will call the post forb routine 


to post the forb with an invalid ftorb parameter error, then call 
the terminate task routine. 


3.2.5.1 DEACTIVATE LOCAL SAP ROUTINE 


The deactivate local sap routine will clear all active 
requests outstanding on the sap specified, and place ‘the sap into 
a non active state. Note: a lan type ftorb Is not required for 
This request. The routine requires the following input 
parameters: 


$b 1 a(irb) 

$b2 a(rct) 

lorb with major function code = b 
device specific word bit e set 


The routine supplies the following output parameters: 


none = level {is exited via a call to the terminate task 
routine 


The routine performs the following function: 


Ls lf bit f of the forb device specific word fs _ set 
branch to the terminate. remote sap routine. 


2% lf bit e of the forb device specific word [fs not set, 
call the post forb routine with an f[nvalid forb 
parameter error, call the terminate task routine. 


be Mark the rct Into deactivate mode. 
4. Cali the deactivate flow control routine (to purdge 
all requests queued because of flow control and reset 


flow control parameters). 


ver Retrieve a l!cb from memory, fill ifn the deactivate 
local sap Itcb fields, [ssue the Icb via a all to the 
[dms. 


6. Call the terminate task routine. 
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The lacs will recleve the deactivate Icb and post al! 
orders associated with the sap back to the 16. £xWhen 
the requests are posted back, the layer server 


(invoked because of a call from the Idms running aft 
Interrupt level) will determine that the sap is in 
deactivate mode and call the deactivate mode routine 


to handle the processing. 


lf the completed Icb Is not the deactivate request, 
the routine will call the post torb routine to post 
the request with the specified status. lf the ret Is 
marked as the deactivate was received before other 
requests have completed mode and If there [Is only one 
request left on the rect queue (it would be the 
deactivate) and the request fs finished, the routine 
will call the post request routine to post the forb 
with a successful status then mark the ,.rct as not 
active and clear the deactivate mode bit and the 
recefved bit, the routine will return to the Idms. 


‘If the completed Icb [Is the deactivate request, the 


routine will test If only one request {is on the rct 
queue (this would be the deactivate request) and [f so 
will call the post forb routine to post the request 


with a successful status, then mark the ret as not 
active and take the rct out of deactivate mode, then 
return to the Idms. [If there are more requests on the 
queue, the routine will update the deactivate lforb, 
mark the rect Into deactivate received before other 
request have completed mode and return to the Idms. 


~2 DEACTIVATE REMOTE SAP ROUTINE 


The deactivate remote sap routine Is [Invoked via a. branch 
from the deactivate local sap routine. The routine requires the 


following 


$b 1 
$b2 


input parameters: 


a(irb) 
a(rcTt) 


lorb major function code = b 
device specific bit e set in the Torb 


Ther routine supplies the following output parameters: 


none 


The routine performs the following function: 


tbd 
COMMON 
The 


a layer 
routines 


LAYER SERVER ROUTINES 


common layer server routines are [nvoked via a Inj from 
server. Except for the terminate task routine all the 
will return to the calling routine. 
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ae oy TERMINATE TASK ROUTINE 

The terminate task routine Is called by a layer server when 
it wishes to terminate it's task level, the routine resets the 
start address to the forb preprocessing routine, note: this 
routine Is not used by the megabus Interface services when if Is 
operating at interrupt level. The routine requires the following 
Input parameters: 

none 
The routine supplies the following output parameters: 

none 


The routine performs the following functions: 


ee Retrieve the null address from ,zhcomm and place it 
Into $b4. 

Z% Call the terminate task routine, this routine will 
terminate the level, and the start address will be set 
to the next Instruction. Therefore, the next 
instruction fis a branch to the tforb preprocessor 
routine. 


g 2.4.2 BUILD LCB ROUTINE 


The build Icb routine will fill In certain common fields In 
the !cb from the ret and =tHiorb. The routine requires’ the 
following Input parameters: 


$b1 = al(lcb) 

$b4 = a(forb) 

$b2 = al(rct) 

$b3 = altt) 

$b5 = return address 


The routine supplies the following output: 


$b1 = a(lcb) 
$b4 = a(lorb) 
$b2 = alrct) 
$b3 = al(tt) 


The routine performs the following function: 


1. The routine fills in the following fields of the Icb: 
cb pri - clears the field. 
cb_ncb - set the fleld to null. 
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cb orct 


cb_lit 


cb_Iicw 


cb_cts 
cb_fss 


cb_cbs 


cb_Irs 
cb_lis 
cb_tng 


cb_adr 


cb_rng 


3.2.4.5 VALIDATE !ORB ROUTINE 


The validate 
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sets the pointer to the rct Into the 
field, the pofnter to the rct is 
retrieved from the input parameterl!. 


sets the pointer to the lit Into the 
field, the pointer to. the IIt ts 
retrieved from the Tt. 


sets the field from bits In the Jit 11] 


id2 word. word 

clears the field. 

clears the field. 

clears the left byte, sets the number of 
buffers Into the right byte, number of 
buffers Is known from the forb. 

copies the rb_dad field from the forb. 
copies the Ist_Is field In the local sap 
table, pofnter to the local sap table Is 
retrieved from the rct. 

copies the rb_rng fleld from the forb. 
set the field from the forb or buffer 
discriptor after calling the exec 


absoultizing routine. 


set the field from the ftorb or buffer 
discriptor. 


routine will validate certain flelds of 


the ftorb. The routine requires the following [Input parameters: 


$b4 = al(lorb) 
$b2 = alrct) 
$b5 = 


return address 


The routine supplies the following output parameters: 


$b4 = a(forb) 
$b2 = a(rct) 
$r1 = status 

0 =- forb 


is validate 


4 - forb contains [nvalid parameters 


The routine performs the following function: 


The fflelds this 


routine validates will be determined when 


the layer servers are speced. 
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“2,5 POWER FAIL RESTART ROUTINES 


3.2.5.1 FIRST POWER FAIL ROUTINE 


The Ith pf routine will be invoked by the executive pf restart 
routine. The exec pf restart routine will retrieve the s_Inpf 
field In the scb and then Inj to the address specified. The Idms 
Ist code will set up the pointer In the s_Inpf field to be the 


ith pf routine entry point. The routine also requires cim to 
place the tcb pointer of the lowest lan Interrupt level Into the 
cd_teb field of the cd. The ith pf routine requires’ the 
following [nput parameters: 


$b5 = return address 
no stack 


The routine supplies the following output parameters: 

none 
The 16 experfences a power failure, the executive pf restart 
routine [s Invoked at system tevel 2. The executive performs a 
Inj to the address specified In the s_Infp field In the scb. The 
1th power fall routine performs the following: 


ae Retrieve the pointer to the cd from the scb. 


Li ‘Retrieve the tceb pointer for the lowest lan [Interrupt 
level from the cd. 


3% Places the address of the 2nd lan pfrs routine Into 


the p-counter [n the tcb of the lowest [an [nterrupt 
level. , 
4. Performs a lev (to emulate an Interrupt) to [Invoke the 


lowest lan Interrupt level. 
Da Returns to the executive pfrs routine. 
3.2.5.2 SECOND POWER FAIL ROUTINE 

The 2nd pfrs routine {fs Invokes as a result of the lev performed 
by the ith pfrs routine. The routine requires the following 
Input parameters: 

none 
The 2nd pfrs routine supplies the following output parameters: 


none 


The 2nd pfrs routine performs the following function: 


ie Retrieves the pointer to the cd from the scb. 
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2. Retrieves the pointer to the ud from the cd. a 
a For each entry, the rect associated with It is. ie 
retrieved, and all requests active on that ret (iIrb 


queue) are posted back to the user with a power fall 
error status, unless the Icb's completion bit I[s set, 
then the request is posted back successfully. 


4.. All structures are cleaned up, they are placed back 
into the state they were at before any local sap was 
activated. 


Sy All tan teb are checked, and If they are active, (l.e. 
the level had been Interrupted) their p-counters are 
changed To the exit level routine. 


Notes: 

Pg The users must reactivate, at this time’ the 
controllers will be loaded (ifn the exact manner as 
done In any activate). 

Zs Any subsequent requests Issued to the lan subsystem 
(other than activate focal sap requests) will be 
posted back to the user with an software not, loaded 
error. | 

PDL 
TBD 
ISSUES : 


Quiity of service 


States 


Flow control 

Events in a co enviroment 

Lost Icbs, !cb nak'd when controller Is down 
Mutiple cpus 

Group tsaps 

Errors need to be defined 


System preprocessor (exec's won't be ready until 4.1) 


- 39 - 


Lacs Driver Interface Services ; Component Specification 


10. Different Icb, forb for different functions 


i. Define the function specific word, 4 bits forb function, 12 fs 


12. Ldis and Idms need to be seperate bound units because of the Ist 


code the Idms has to run. 

13. Define the lass and lassi ec's, 
14. Define events. 

QUESTIONS 

1. Does zqeasd handie a buffer list? 


2 Does exec need return status [n the forb or does he 
h | m s e [ f f room 
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